home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ShareWare OnLine 2
/
ShareWare OnLine Volume 2 (CMS Software)(1993).iso
/
elecmail
/
skill28.zip
/
SPOTKILL.DOC
< prev
next >
Wrap
Text File
|
1993-05-22
|
19KB
|
360 lines
┌─────────────────────────┐
│ Spot Kill 2.8 │
└─────────────────────────┘
!!!! WARNING !!!!
!! This Program Is Designed for GT 16.00 and Higher Specifically !!
!! Use on any other version could prove hazardous to your system !!
──────────────────────────────────────────────────────────────
History
──────────────────────────────────────────────────────────────
01-26-92 Ver 1.0 Initial Release
01-29-92 Ver 1.1 Added 'ANY' argument to "Search Area" and
"Flags"
02-02-92 Ver 1.2 Added /P: Parameter to Command Line.
(Ability to search Alternate Echo Path)
02-03-92 Ver 1.3 Added /C: Parameter to Command Line.
(Ability to specify Alternate Config File)
02-08-92 Ver 1.4 Added Result Logging. Unless a /NL is
placed on the command line SPOTKILL will write a
progress log to a file called SPOTKILL.LOG in the
GTPATH directory.
04-05-92 Ver 1.5 Added ALL Argument to the "FLAGS" area of
the CFG file. If you add ALL to the "FLAGS" area
every message meeting the "Search Area" and "Text
Search" parameter WILL be deleted whether it has
been bagged or received. USE WITH CAUTION!
11-07-92 Version 1.6 SpotKill has received an overhaul.
ALL command line parameters are now obsolete, they
are no longer needed as the configuration file has
been almost completely redesigned. Please read the
WHATS.NEW file for upgrade information.
11-08-92 Version 1.7 This release fixes some minor bugs
that was found in version 1.6. Corrections include
ability to use /REGISTER with the QWK compatible
GTMDIR.BBS and corrected a never ending loop that
would happen if the last END statement was not
placed into the SPOTKILL.CNF.
11-09-92 Version 1.8 Improved result logging. SPOTKILL
now puts the date (the correct one which was fixed),
the message are being processed, and a listing of
all messages deleted. SPOTKILL also reports if no
messages were deleted in the log file.
12-06-92 Version 1.9 Several Additional and Modified Flags,
as well as some feature changes. The two new flags
for SpotKill are INCOMING and IN_RECEIVED. You can
now specify the message to be an INCOMING message
or an INCOMING/RECEIVED message prior to deletion.
Three flags have been renames ALL is now KILL_ALL,
ANY is now ANY_STAT and BOTH is now BOTH_STAT. In
the search location the ANY has changed to ANY_LOC.
SpotKill will now also allow you to Mark Messages
as bagged rather than completely deleting them.
If you would prefer to simply mark your offending
message as bagged rather than kill them, place a
/MB (mark bagged) on the command line.
12-27-92 Version 2.0 Some additions have been made at the
suggestion of Bob Butcher. The first change is the
addition of the "Message - O - Meter". The "meter"
will give you graphic representation of the percentage
of the message base that has been scanned, and how
much remains. The second addition is the ability to
make three distinct "breaks" out of the program.
Listed at the top of the screen you will notice that
the F1 F2 and F3 keys will allow you to break out of
the various Spotkill Loops. F1 will break out of the
current search and continue with the next search in the
message area. F2 will tell Spotkill to continue on to
the next message area. F3 will do a graceful and
immediate exit from the program.
2-01-93 Version 2.1 Two new features have been added to
SPOTKILL. SPOTKILL can now GLOBALLY process each
message area listed in the GTMDIR.BBS file. To force
a GLOBAL process, place the word GLOBAL in the
SPOTKILL.CNF file instead of a PATH to the message
area. When SpotKill see's GLOBAL as the pathname, each
and every message area listed in the GTMDIR.BBS file
will be searched. SPOTKILL also has a new command line
parameter /NOMETER. If you don't want to see
SpotKill's MESSAGE - O - METER use /NOMETER.
2-02-93 Version 2.2 Bug Fix. Corrected Problem reading
GTMDIR.BBS
2-03-93 Version 2.3 Bug Fix. Corrected Problem in the F1
(Skip Current Search) routine. Thanks to Bob Butcher
for catching this one (one day late though ).
2-14-93 Version 2.4 Added Alternate Config File Command Line
Option. If you wish to use a Config FIle other than
<GTPATH>\HOTWARE\SPOTKILL.CNF then you can specify a
/C:<ALT_CONFIG> where <ALT_CONFIG> is the full path and
filename of the file you wish to use for the
configuration file.
3-07-93 Version 2.5 Now only the message areas that actually
have messages deleted or marked bagged will be logged
into the SPOTKILL.LOG. No more searching the log
file in search of actual work....
3-15-93 Version 2.6 Corrected a problem with '#' as a flag in
the GTMDIR.BBS file.
5-21-93 Version 2.7 Never Really Released.
5-22-93 Version 2.8 hopefully corrected a problem some folks
were encountering with Stack Overflow problems. This
version will also put the name of the echo on the
screen rather than the path of the echo when working in
GLOBAL mode.
──────────────────────────────────────────────────────────────
What is It?
──────────────────────────────────────────────────────────────
A simple little program that will go to your netmail message
area and "Spot Kill" (or just mark them as bagged if you prefer)
any messages you choose. SPOTKILL reads from a configuration file
(discussed below) and deletes selectively by Message Sender,
Receiver, or Subject. In the config file you must specify the
path of the message area to process, whether the message has to be
Received, Bagged, Incoming Any_Stat (Bagged or Received),
Both_Stat (Bagged AND Received), or IN_Received (Incoming message
that has been received). Any messages that are found must match
the text you have chosen to search for and the bagged / received /
incoming flag combinations before the message will in any way be
removed. Bear in mind however the text you choose will be searched
for in a case insensitive manner. If the text appears ANYWHERE in
the section you have chosen to search (Sender Receiver or Subject)
the message will be subject to deletion. For example, if you
choose to delete any Received messages with "NET" in the subject,
the following Subject lines would be subject to deletion: Netmail
System Report Net 064 Discussions FIDONETWORK Expo
As you can see, if NET appears ANYWHERE in the text and the
Received flag was set on the message, this message would be
history.
──────────────────────────────────────────────────────────────
Why Is It?
──────────────────────────────────────────────────────────────
You may be asking about now, Why would you want to do this?
It's simple. On my system, there are several messages that
travel through concerning, Automated File Attach Messages,
Netmail Reports, Echo Requests, etc. With SPOTKILL I can
automatically remove these type messages automatically each night
after they have either been bagged or received without any manual
intervention.
──────────────────────────────────────────────────────────────
Execution..
──────────────────────────────────────────────────────────────
Running the program is very easy. The only things that are
required are: 1. A valid GTPATH statement, 2. SPOTKILL.CNF
located in <GTPATH>\HOTWARE directory. (described below).
Now for this SPOTKILL.CNF file:
SPOTKILL.CNF may contain information for an unlimited number of
message areas. Each section is divided by the word END. The
start of each Message Area section must start with the full path
of the message area to process OR the word GLOBAL. If GLOBAL is
used SpotKill will read the GTMDIR.BBS file in your GTPATH and
execute on each valid message area. Following the full path
SPOTKILL will read two lines for each "Text Search" that will take
place. The number of searches that SPOTKILL can perform on each
run is unlimited. The format of the file looks like this, (The
offsets after the text search is optional, although suggested for
easier readability of your .CNF file):
E:\GTMAIL\NETMAIL
"Text To Search For"
"Search Area" "Flags"
END
A practical Example:
E:\GTMAIL\NETMAIL
GT-TOOLS
SENDER BAGGED
ECHOMAIL REPORT
SUBJECT RECEIVED
ROB ROESCH
RECEIVER BOTH_STAT
NETMAIL SYSTEM
ANY_LOC ANY_STAT
END
GLOBAL
SPONSOR
RECEIVER KILL_ALL
E:\GTMAIL\NETMAIL2
GT-TOOLS
SENDER BAGGED
END
The above example would make four passes through the message area
E:\GTMAIL\NETMAIL. The first Pass would look for the text
"GT-TOOLS" (case insensitive) in the Sender section of the
message. If this was found, SPOTKILL would look to see if the
message had been bagged, and if so the message would be deleted.
If the message had not yet been bagged, the message would NOT be
deleted. The second pass would look for "ECHOMAIL REPORT" (again
case insensitive) only this time the text would be looked for in
the Subject of the message. If "ECHOMAIL REPORT" were found
anywhere in the Subject of the message, and the message had been
marked as received the message would be deleted. On the third
pass "Rob Roesch" would be searched for in the Receiving section
of the message. If "Rob Roesch" is found the message must be BOTH
received and bagged before the message will be deleted. On the
fourth pass, if "NETMAIL SYSTEM" were found in ANY of the three
areas (Sender, Receiver, or Subject) and either the BAGGED >OR<
RECEIVED flags were set, the message would be deleted. After
E:\GTMAIL\NETMAIL was completely processed SPOTKILL would start
the process again only this time GLOBALLY for each message area
found in the GTMDIR.BBS file. SpotKill will search each message
area looking for SPONSOR in the Receiver section of the message
header. After the GLOBAL process is complete SPOTKILL would start
in the message area E:\GTMAIL\NETMAIL2. Please note that END (starting in column 1)
separates the three sections. Without the END statement
SPOTKILL will not know to start processing the next message area.
Valid "Search Area" arguments are:
SENDER RECEIVER SUBJECT ANY_LOC
Nothing else will be recognized and the program will exit with an
error.
Valid "Flags" arguments are:
BAGGED RECEIVED BOTH_STAT ANY_STAT KILL_ALL
INCOMING IN_RECEIVED
BAGGED Any BAGGED message meeting the "Text Search"
criteria will be deleted.
RECEIVED Any RECEIVED message meeting the "Text Search"
criteria will be deleted.
BOTH_STAT Any BAGGED *AND* RECEIVED message meeting the
"Text Search" Criteria will be deleted.
ANY_STAT Any BAGGED *OR* RECEIVED message meeting the
"Text Search" criteria will be deleted.
INCOMING Any INCOMING messages meeting the "Text
Search" criteria will be deleted.
IN_RECEIVED Any INCOMING messages, that have be previously
received AND meed the "Text Search" criteria
will be deleted.
KILL_ALL >>ALL<< messages meeting the "Text Search"
criteria will be deleted. USE WITH CAUTION!
Nothing else will be recognized and the program will exit with an
error.
Note: SPOTKILL.CNF MUST be in a directory off your GTPATH
directory named HOTWARE. ie. if your GTPATH is set
to C:\GT then SPOTKILL.CNF must be in C:\GT\HOTWARE
──────────────────────────────────────────────────────────────
Command Line Parameters
──────────────────────────────────────────────────────────────
There's five.
/LOG
If you want SPOTKILL to keep a log file of the messages that
were deleted simply put /LOG on the command line.
/MB
If you want SPOTKILL to mark messages as bagged rather than
delete them, put a /MB (Mark Bagged) on the command line. No
message will be deleted, but they won't travel off your BBS
either.
/NOMETER
If you would like to shut of SpotKill's Message - O - Meter,
use this parameter. SPOTKILL will execute somewhat faster
without the meter, and besides if your running it automatically
at midnight, why would you want the meter there....
/C:<ALT_CONFIG>
If you wish to use a Config FIle other than
<GTPATH>\HOTWARE\SPOTKILL.CNF then you can specify a
/C:<ALT_CONFIG> where <ALT_CONFIG> is the full path and filename
of the file you wish to use for the configuration file.
/REGISTER
If you would like to use the Auto Registration feature of
SPOTKILL, use this parameter. SPOTKILL will send a registration
message to ROB ROESCH at 064/003 via netmail when this parameter
is used.
──────────────────────────────────────────────────────────────
Active Keyboard Input
──────────────────────────────────────────────────────────────
Spotkill has the ability to exit various levels of execution at
your request. There are three distinct "breaks" out of the
program. Listed at the top of the execution screen you will
notice that the F1 F2 and F3 keys will allow you to break out of
the various Spotkill Loops. F1 will break out of the current
search and continue with the next search in the message area.
F2 will tell Spotkill to continue on to the next message area.
F3 will do a graceful and immediate exit from the program.
──────────────────────────────────────────────────────────────
Errorlevels
──────────────────────────────────────────────────────────────
Here are the possible errorlevel exits the program will give.
ERRORLEVEL 0 No Problems, Good Run.....
ERRORLEVEL 1 GTPATH Not Set
ERRORLEVEL 2 Cannot find SPOTKILL.CNF
ERRORLEVEL 3 Cannot Open GTMDIR.BBS
ERRORLEVEL 4 Cannot Find NETMAIL Area in GTMDIR.BBS
ERRORLEVEL 5 Cannot Open MESSAGE.CTL
──────────────────────────────────────────────────────────────
Registration
──────────────────────────────────────────────────────────────
I am not requesting any money for this program, but I would
not turn any down either <g>. If you want to slip $5.00 into
and envelope I'll accept it. Although I don't require a
registration fee I would appreciate knowing that you are using
the program on a normal basis. Therefore I have provided a
simple and easy way for you to register this program. From
the DOS prompt type:
SPOTKILL /REGISTER
SPOTKILL will the proceed to send me a netmail message informing me
that you are using the program. Please use this feature ONCE.
──────────────────────────────────────────────────────────────
Who Is Responsible for This?
──────────────────────────────────────────────────────────────
Rob Roesch
The HOTware BBS
GT Power Net-Node 064/003
Rt 7 Box 566
Mocksville, NC 27028
704-492-2081 (USR 16.8 DS)
If you start using this utility, and get a chance, let me know
(see above procedures. If you don't have any use for it, delete
it for your total refund of all the disk space that it was
occupying. This program comes with no warranty, no guarantee,
and no promises. If it works GREAT, if not let me know and I
will gladly take a look at it in my spare time. If you really
really really like the program and want to make any donations,
feel free, but it is not a requirement.....